home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 4 / Precision Software Applications Silver Collection Volume 4 (1993).iso / database / logit302.exe / LOGIT302.DOC < prev    next >
Text File  |  1989-01-22  |  64KB  |  1,809 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   LogIt!(R)
  8.  
  9.            
  10.              The fast, RAM-resident, computer use logging program.
  11.  
  12.  
  13.                          DOCUMENTATION FOR LogIt!(R) 
  14.  
  15.                                 VERSION 3.02S
  16.                                January 22, 1989
  17.  
  18.          (C)opyright  1988, Alan E. Robertson & John W. Beasley
  19.          "LogIt!" is a registered trademark of the authors.
  20.      LOGITRPT is compiled with Quicksilver(R) and portions of this
  21.      program are Copyright 1984, 1985, 1986 and 1987 by 
  22.      WordTech Systems, Inc.   
  23.  
  24.  
  25.               ** Please Support the Shareware Concept **
  26.  
  27.          If you find LogIt! to be useful, we ask you to follow the 
  28.          registration instructions at the end of this document file.
  29.  
  30.      You are encouraged to copy and distribute this program 
  31.      provided the following conditions are met.  First, the program
  32.      must be distributed as the intact archive (LOGIT302.ARC) with no 
  33.      modifications. Please upload it with the identification:
  34.           "Log computer use by time & keystrokes"
  35.  
  36.      Second, you may charge a reasonable amount, not to exceed $6.00
  37.      per disk, for distributing this program.  Persons purchasing such
  38.      disks must not be led to think that they have paid the 
  39.      registration fee for LogIt!.   Site licenses are available.
  40.  
  41.      Finally, please pay $20 for each copy in use to:
  42.  
  43.                             Robertson Software 
  44.                 Dept. LS-3
  45.                 P. O. Box 576
  46.                 Geneva, IL, 60134
  47.  
  48.          Versions 3.0xS of LogIt! have new usage summarizing and reporting 
  49.          features which are greatly improved over those in prior versions.  
  50.      LogIt!  was previously marketed by the University of Wisconsin
  51.      Software Development and Distribution Center (SDDC).  The rights
  52.      to the program have been returned to the authors.  See the notes
  53.      on History of LogIt!  (Page 7) for details.
  54.  
  55.      DISCLAIMER:  You use LogIt! at your own risk.  We have worked hard
  56.      to make it compatible with most systems and programs and believe
  57.      it to be a good program.  However, we can accept no responsibility
  58.      for damages resulting or believed to result from its use except
  59.      to refund your registration fee.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                      ***   TABLE OF CONTENTS   ***
  68.  
  69.  
  70.  
  71.     I.    QUICK INSTRUCTIONS (If you really don't like reading)......1
  72.  
  73.     II.   INTRODUCTION ..............................................2
  74.         A.   What is LogIt! ?                  
  75.                 B.   What others say about LogIt!      
  76.                 C.   How LogIt! works                   
  77.                 D.   Equipment requirements
  78.         E.   Limitations and conflicts 
  79.         F.   The LogIt! files
  80.  
  81.     III.  HISTORY OF LogIt! (Why you've seen it before)..............7
  82.  
  83.     IV.   HOW TO INSTALL LogIt!......................................8
  84.         A.   Hard disk systems
  85.         B.   Floppy disk systems
  86.         C.   How to set up the computer for LogIt!
  87.         D.   Other operating notes
  88.  
  89.     V.    HOW TO START LogIt! AND ENTER INFORMATION.................12
  90.              A.   How to run LogIt!
  91.         B.   How to make LogIt! entries
  92.         C.   Tips for making INFORMATION entries
  93.  
  94.     VI.   HOW TO EXIT LogIt!........................................15
  95.  
  96.     VII.  HOW TO USE LOGITRPT TO SUMMARIZE LogIt! RECORDS...........16
  97.         A.  What does LOGITRPT do?
  98.         B.  How to use LOGITRPT
  99.                 C.  Notes on screen displays of data
  100.                 D.  Cleanup Procedures
  101.         E.  Other notes regarding LOGITRPT
  102.         F.  Other uses for LOGITLOG.TXT and .DBF files
  103.  
  104.     VIII. HOW TO USE LOGITDMP TO READ LogIt! RECORDS................20
  105.         A.  General operations
  106.         B.  How to use LOGITDMP
  107.         C.  How to display and print files created by LOGITDMP
  108.         D.  How to interpret records produced by LOGITDMP
  109.  
  110.     IX.   PROBLEMS AND ERRORS.......................................25
  111.         A.  When LogIt! will not create a record
  112.         B.  Common Error Messages
  113.         C.  Who to contact if there are problems
  114.         D.  Detailed list of known conflicts and limitations
  115.  
  116.     X.    REGISTRATION INSTRUCTIONS AND INVOICE.....................27
  117.  
  118.  
  119.  
  120.      I.   QUICK INSTRUCTIONS (For those expert with computers)
  121.  
  122.     A.   Make a directory (\LOGIT) on the hard disk.  Copy all the 
  123.              files in this archive or distribution disk to that directory.
  124.  
  125.     B.   Copy LOGIT.COM to the root directory of your hard disk. 
  126.  
  127.     C.   Be sure CONFIG.SYS contains the line FILES=20
  128.  
  129.     D.   Modify your AUTOEXEC.BAT file with the following:
  130.         1.    Add the command SET LOGIT.LOG=C:\LOGIT.LOG.  This
  131.               assures that all log data is in C:\LOGIT.LOG
  132.         2.    Add the PATH statement PATH=C:\; to assure that 
  133.               the command LOGIT always works.
  134.         3.    Add the command LOGIT  after the command which
  135.               sets the clock-calendar.  If there is nothing  
  136.               (not even a parameter) after "LOGIT" the window 
  137.               will come up, forcing an entry.
  138.  
  139.     E.   The first time LogIt! is invoked after booting, the
  140.          program will be loaded to RAM, and a prompt will display.  
  141.  
  142.     F.   LogIt! automatically records program entries and exits.  To
  143.          record information manually, either use the <ALT><INS> hotkey or
  144.     enter information by typing (or including in a batch file) the 
  145.          command LOGIT and the information desired after the command.
  146.  
  147.     G.   Exit programs to DOS  * before *  shutting down the computer 
  148.     so LogIt! can record the exit time and calculate the proper 
  149.     elapsed times.  If the -^E switch (below) is used, it is necessary
  150.     to use the <ALT><INS> hotkey or a "QUIT.BAT" batch file with the 
  151.     command LOGIT in it to establish an exit time.
  152.  
  153.     H.  For a summarized report listing users, programs and percentages
  154.     of use, use the command LOGITRPT and follow the prompts.  
  155.  
  156.     I.   For a quick, unsummarized report of log data, use LOGITDMP to 
  157.         convert the log data from the original LOGIT.LOG file.  The command 
  158.         LOGITDMP can be used to report to the screen, a printer or a disk 
  159.         file.  As the default, LOGITDMP  will write text to the screen. 
  160.         LOGITDMP will display times and keystrokes as "S>" (start),
  161.     "I>" (information), "P>" (program in operation),  and 
  162.     "D>" (in DOS) entries. 
  163.  
  164.     J.  Switches for LOGIT.COM  include:
  165.               -E     (default) - records "everything"
  166.                       -^E   - record only START and INFORMATION
  167.                  entries ("Not-Everything")
  168.                       -H    (default)  - enables <ALT><INS> hotkey
  169.                       -^H   - disables hotkey
  170.  
  171.     K. Switches for LOGITDMP.EXE include:
  172.               -I  - reports START and INFORMATION 
  173.                             entries only (no PROGRAM/DOS)
  174.                       -S  -displays clock times down in HR/MIN/SEC format
  175.                       -D  -produces a file in DIF format 
  176.  
  177.     L. Send a check for $20 ($10 if upgrade) per copy in use to:
  178.            Robertson Software, Dept LS-3, Box 576, Geneva, IL,  60134
  179.  
  180.                 Page 1
  181.  
  182.  
  183.  
  184.  
  185.  
  186.      II.  INTRODUCTION:  
  187.  
  188.         A.  What is LogIt!(R) ? 
  189.  
  190.     LogIt!(R) is the RAM-resident logging program that automatically
  191.         records clock time, elapsed times and keystrokes used while you 
  192.         are using each program during the time spent in "Information" 
  193.         entry categories such as user names or account identifiers.
  194.      
  195.         LogIt! is:
  196.  
  197.         * - FAST
  198.            - Automatic recording of program use
  199.                - Automatic log-in from batch files
  200.                - <ALT><INS> Hotkey entry of information 
  201.                - No menus to call up
  202.                - Automatic log-out
  203.  
  204.         * - EFFICIENT
  205.                - Usually less than 25 bytes per entry in log file
  206.                - Resident portion uses less than 10K of RAM
  207.                - Records as much or little information as you wish
  208.  
  209.         * - VERSATILE
  210.                - Produces secure, tamper-proof binary master log file
  211.                - Reports detailed text record to screen, file or printer
  212.                - Produces DIF file for export to database or spreadsheet 
  213.            - Calculates a summary report of all use and percentages 
  214.          of use by user or program used.
  215.  
  216.         * - EFFECTIVE
  217.                - Records clock times
  218.                - Records elapsed times
  219.                - Records number of keystrokes used
  220.  
  221.     LogIt! is ideal for anyone wishing to keep a record of computer
  222.     usage for either personal or business reasons.  LogIt! is
  223.     especially useful for legal, accounting programming and other 
  224.     professions which require a record of time for billing purposes.  
  225.     It is also useful for documenting the use of a personal computer 
  226.     for tax deduction purposes.
  227.  
  228.  
  229.         B.  What others say about LogIt! 
  230.  
  231.     "Once installed, the 10K program is automatically invoked upon 
  232.     booting the machine.  It counts .... each keystroke.  It starts 
  233.     a new record each time the user returns to DOS or whenever he 
  234.     or she switches applications.  The user can label activities 
  235.     at any time, even from within applications...."  
  236.              Technological Horizons In Education Journal, February, 1988
  237.  
  238.  
  239.  
  240.  
  241.                 Page 2
  242.     
  243.  
  244.  
  245.  
  246.     "If you use your .... computer less than 100% for work (as 
  247.     defined by our favorite agency, the IRS) you ought to keep 
  248.     careful daily use records.   If you're at all like us, you'll
  249.     love $40 LogIt!  .... LogIt! records the name of each 
  250.     program used and the elapsed time using it.  You can annotate 
  251.     the entries and once they're written they're nearly 
  252.     tamper-proof....  (Here's how to find out if the kids are 
  253.     playing games on your computer!)."
  254.          Computer Talk, P/K Associates, Inc., September, 1987
  255.  
  256.     "LogIt!'s forte is tracking who uses your PC and at what time,
  257.     for how long, and with what applications.....Users hit the 
  258.     hotkey from within any application to record text information
  259.     or a new user name in the LogIt! file.  This allows you to note
  260.     any specific activities throughout the day and make the LogIt! 
  261.     file clearer.
  262.     Without too much difficulty, we loaded LogIt! onto the hard 
  263.     disk of our Victor 286 machine.  After rebooting the machine, 
  264.     the LogIt! window popped up asking for information.  We entered
  265.     the user name and proceeded to go about the morning's activities
  266.     ....LogIt! recorded all the daily activities, including 
  267.     information lines.
  268.     LogIt! runs on any computer running ...DOS 2.0 or later."
  269.       InfoWorld, Short Looks, April 27, 1987
  270.  
  271.  
  272.     C.  How LogIt! Works. 
  273.  
  274.     When LogIt! is in operation, the program LOGIT.COM is loaded to
  275.     RAM and, once there, is transparent to the operations of other 
  276.     programs.  LogIt! information is recorded in a file LOGIT.LOG 
  277.     (default name).  As noted below, all programs run by DOS can be 
  278.     logged automatically. Other information (such as a user ID or
  279.     a project ID) can be logged by typing <ALT><INS> or from the 
  280.     command line using the command LOGIT or a batch file procedure.  
  281.     The elapsed time and the number of keystrokes used for PROGRAM/DOS 
  282.     and each "INFORMATION" entry is recorded in the log file.  
  283.  
  284.     LogIt! simultaneously tracks two types of use data.  The first
  285.     is "PROGRAM/DOS" usage where the time and keystrokes are tracked
  286.     according to whatever program is in operation at the time.  The
  287.     second is "INFORMATION" usage where the time and keystrokes are
  288.     tracked according to information entered with the command LOGIT 
  289.     or the <ALT><INS> hotkey.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.                                  Page 3
  302.  
  303.  
  304.  
  305.  
  306.  
  307.     To read the LogIt! log record there are two procedures for you 
  308.     to use.
  309.     
  310.     First, for a summary report showing the total usage and 
  311.     percentages of use by each PROGRAM/DOS or INFORMATION entry
  312.     the program LOGITRPT.EXE is used.  The instructions screens are
  313.     pretty much self-explanatory.  The report can be to either
  314.     the screen or the printer.  See page 16.
  315.  
  316.     Second, for a quick, detailed, unsummarized view of the log record, 
  317.     use LOGITDMP.EXE.  LOGITDMP.EXE will display the contents of the 
  318.     binary LOGIT.LOG file on the screen, print it, or copy the data to 
  319.     another file.  As a default, it will produce a text display on the 
  320.     screen.  LOGITDMP.EXE can also create a text file on a disk or a 
  321.     Data Interchange Format (DIF) file.  See page 20.
  322.  
  323.     When you first invoke LogIt! (usually from your AUTOEXEC.BAT file)
  324.     LogIt! will make a "START" entry, recording the time of the START.
  325.  
  326.  
  327.  
  328.     D.  Equipment Requirements 
  329.  
  330.     LogIt! will work well on any IBM or true compatible computer running 
  331.     PC DOS or MS DOS Ver. 2.1 or later.  LogIt! requires one or more disk 
  332.     drives, and will work best with a hard disk and a clock-calendar.  
  333.     When loaded, LOGIT.COM uses less than 10K of RAM. 
  334.  
  335.     LOGITRPT requires 384K or more of available RAM (after use by 
  336.     system     and RAM-resident programs).  If you intend to use 
  337.     LOGITDMP only then just 64K of RAM is needed.
  338.  
  339.     A hard disk is nearly essential for the reporting functions
  340.         since the data in the compact binary file generated by LogIt! 
  341.         will expand about 50 times when it is processed and summarized.  
  342.  
  343.         Thus, if your LOGIT.LOG (or other file) generated 
  344.         by LOGIT.COM is 10K in length, you will need up to a total of 
  345.         nearly 500K of disk space.  Furthermore, while LOGIT will run 
  346.         well on floppy disk systems, the data may become fragmented over 
  347.         several disks as you change disks in the system.  If you haven't 
  348.         already purchased a hard disk you might as well go ahead and do it 
  349.     now!
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.                 Page 4
  363.  
  364.  
  365.  
  366.  
  367.  
  368.     E.  Limitations and Incompatibilities 
  369.  
  370.     Every effort has been made to ensure LogIt! operates effectively 
  371.     with as wide a range of programs as possible. LogIt! is compatible 
  372.     with most common RAM-resident programs.
  373.    
  374.     However, there are circumstances when LogIt! will not work properly.  
  375.     To date, there have been no documented instance of data or disk 
  376.     damage related to LogIt! use.  However, the possibility of that 
  377.     occurring (or seeming to occur) cannot be completely ruled out.  
  378.     Therefore, the authors accept no responsibility for damages beyond 
  379.     the refund of the price of LogIt!.   If you find incompatibilities 
  380.     other than those in the detailed list (IX. D.) below, please let 
  381.     us know about them.
  382.  
  383.     Some RAM-resident programs may conflict with the hotkey and 
  384.     experimentation with order of loading may be needed to achieve the 
  385.     maximum compatibility with other RAM-resident programs.  Known 
  386.     compatibility problems (shareware and commercial) include:
  387.     MS-Windows, VP-Info, and Software Carousel.  There are also some
  388.     unverified reports of problems, and a few minor conflicts.  For
  389.     a full list of limitations and conflicts, please see Chapter IX,
  390.     section D, the detailed list of incompatibilities and limitations.
  391.  
  392.     LogIt! will record up to 99,999 keystrokes per entry.  After that
  393.     it will indicate keystrokes as nnnK.  Thus, 124,000 keystrokes
  394.     would be indicated as 124K.   LOGITRPT will handle only up to 
  395.     99,999 total keystrokes over all entries of a particular type
  396.     in its summation routines. 
  397.  
  398.     While LogIt! will not cause problems with programs using graphics 
  399.     screen modes it will not bring up a readable entry window with the 
  400.     hotkey while these programs are running.  In a future version full 
  401.     window compatibility with graphics programs will be added. 
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                 Page 5
  420.  
  421.  
  422.     F.   The LogIt!(R)  Files
  423.  
  424.     The LogIt!(R) package (LOGIT300.ARC)  contains the following:
  425.  
  426.     README.1ST      A short description of the LogIt! programs
  427.     LOGIT300.DOC    This documentation.
  428.         PRINTDOC.BAT    Batch file to print this documentation
  429.     LOGIT.COM:    RAM resident, this program generates the LOGIT.LOG 
  430.             data files.
  431.     LOGITDMP.EXE    This converts the log data to a screen display, 
  432.             printed report, or another file.
  433.     LOGITRPT.EXE    Summarizes the log data and calculates the 
  434.                         percentages of keystroke and time use by 
  435.                         INFORMATION and PROGRAM/DOS entry.  It runs 
  436.                         LOGITDMP as a sub-routine.
  437.         V3CFG.DBF       The configuration file 
  438.         V3DB1FMT.DBF
  439.         V3DB2FMT.DBF
  440.         V3DB3FMT.DBF    Set of 3 .DBF format files LOGITRPT.EXE uses
  441.         V3RPT.FRM
  442.         V3PRNT.MEM
  443.         V3RPTD.FRM      Set of 3 files for LOGITRPT.EXE print routines
  444.         ERROR.TXT       File used by LOGITRPT.EXE for error messages
  445.                         (comes with QuickSilver (R) programs)
  446.         CLEANUP.BAT     Gets rid of extra working files when you are done
  447.  
  448.     When you use LogIt! you will create the following files (names 
  449.     indicated are default names, other filenames can be used where 
  450.     indicated by "*")
  451.  
  452.     LOGIT.LOG*      This is the binary file containing all log data 
  453.                         which is created and added to by LOGIT.COM.
  454.         LOGITLOG.TXT*   This is the text file record of the data which
  455.                         is produced by LOGITDMP.EXE when it is run as part
  456.                         of the LOGITRPT routine.  See also HOW TO USE 
  457.             LOGITDMP.
  458.          LOGITLOG.DIF    This is the file produced on the default drive
  459.             if LOGITDMP.EXE is invoked with the -D option.  
  460.         V3DB1.DBF       6 dBase III(r) compatible files containing all
  461.         V3DB2.DBF          log information created by LOGITRPT routine.
  462.         V3DB2A.DBF
  463.         V3DB3.DBF
  464.         V3USAGE.NDX     
  465.         V3SUMTMP.DBF    
  466.  
  467.     All of these 6 files are are temporary and will be overwritten 
  468.         the next time you run  LOGITRPT. If you want to save these files 
  469.         they should be renamed or copied.  LOGITRPT will NOT ask you 
  470.         before overwriting them!  Running CLEANUP will delete all of 
  471.         them if you wish to save disk space.
  472.  
  473.                 Page 6
  474.  
  475.  
  476.  
  477.      III.  HISTORY OF THE LogIt! PROGRAMS:
  478.  
  479.     LogIt! was originally written for the authors' own since we 
  480.     need a record of our computer use.  This turned into a rather
  481.     large project and there was seemed to be enough interest to 
  482.         make it worthwhile to release the program.
  483.  
  484.     You may have seen LogIt! before.  Here's why:
  485.  
  486.     Version 1.0 - Shareware.  Had bug; If you see it, delete it!
  487.  
  488.     Version 1.1 - Shareware. (LOGIT110.ARC) No bugs, but could 
  489.                       not handle programs that invoked other programs 
  490.                       or COMMAND.  Trademark "LogIt!" registered.
  491.  
  492.     Version 2.0 and 2.1 - Commercial versions marketed by the 
  493.                       University of Wisconsin Software Development 
  494.                       and Distribution Center (SDDC) 1986 to 
  495.                       June 30, 1988.  These are the versions advertised 
  496.                       and reviewed in InfoWorld and other publications.
  497.                       Added features included the keystroke counter, the 
  498.                       hotkey for information entry, improved handling 
  499.               for multiple levels of programs, and LOGITRPT
  500.               was added so percentages of use could be easily 
  501.                       calculated for either user or program use.
  502.  
  503.                       In January, 1988, The Board of Reagents of the 
  504.                       University of Wisconsin decided that SDDC should 
  505.                       market only programs that have a clear "academic" 
  506.                       orientation.  Thus SDDC has returned all rights to 
  507.                       the program to us  (Alan E. Robertson and John W. 
  508.                       Beasley, effective 9/1/1988.  We decided to release 
  509.                       that commercial version as shareware. Thus the second 
  510.                       shareware version, Version 2.50S, was identical with 
  511.                       the commercial version with the exception of the 
  512.                       copyright notices, this revised documentation, a 
  513.                       couple of ancillary files and the request for $20.
  514.  
  515.       Version 3.0xS - The shareware version you're looking at right now! 
  516.                       This has a major development of the reporting 
  517.                       program making it possible to develop special reports 
  518.                       by date interval, by selected user or program, and,
  519.                       most importantly, it links the user and the program
  520.                       in the printer report.  Detailed or summary reports
  521.                       are available The LOGIT.COM and LOGIDMP.EXE programs 
  522.                       are unchanged and this version is fully downward 
  523.                       compatable with Version 2.xx log files.
  524.  
  525.       Version 4.x  -  Vaporware. Planned features include greater screen 
  526.                       mode compatibility and a "time-out" feature and other 
  527.                       enhancements. This may be done as commercial work, 
  528.                       but in any case, persons paying the registration fee 
  529.                       for version 2.50S or 3.0xS will receive substantial 
  530.                       discount on the upgrade - as well as notification.
  531.  
  532.  
  533.  
  534.                                     Page 7
  535.  
  536.  
  537.  
  538.  
  539.  
  540.      IV.  HOW TO INSTALL LogIt! 
  541.  
  542.  
  543.     A.  Hard Disk Systems:   
  544.  
  545.     Make a directory with the name \LOGIT.  Copy all files from the 
  546.     archive into that directory.  Copy (or move) LOGIT.COM to the 
  547.     root directory of your hard disk.  See the notes below about 
  548.     configuring your computer for LOGIT.  Both PATH and SET commands 
  549.     in your AUTOEXEC.BAT file are necessary as noted below.  See your
  550.     DOS manual if your don't know how to use the commands MD (Make
  551.     Directory), PATH, and SET.
  552.  
  553.  
  554.     B.  Floppy Disk Systems:
  555.  
  556.     If you are still using a two floppy (or single floppy) system
  557.     LogIt! will still work, but to be honest, it's probably more 
  558.     trouble than it's worth.  Just go ahead and break down and 
  559.     buy a hard disk.  Its time to do so anyway!  But, if you still
  560.     want to use it with a floppy-based system, here's what you do:
  561.  
  562.     Copy LOGIT.COM to all disks you use as boot disks or program 
  563.     disks in your A: drive and be sure that PATH and SET commands
  564.     are used as shown below.   The LOGITDMP.EXE and the LOGITRPT set
  565.     of files need not be on the boot disk since they are needed only 
  566.     to review the data.  If you're going to run this on a two floppy
  567.     system, see the notes below about the amount of disk space that
  568.     LOGITRPT will require.  Disk space should not be a major problem
  569.     with LOGIT running alone since the log file size is reasonable 
  570.     small - only about 25 bytes per entry.  
  571.  
  572.  
  573.     C.  How to Set Up the Computer for LogIt! 
  574.  
  575.         1.  Be sure that your CONFIG.SYS file contains the
  576.         statement:  FILES=20 
  577.  
  578.         2.  Use the SET command to tell the computer where to
  579.             put the file LOGIT.LOG (or other name) regardless of
  580.             which drive is the default rive.
  581.  
  582.         The LogIt! program will create a file named LOGIT.LOG on
  583.         the disk in the default drive (or any drive chosen). It
  584.         will do this as often as it does not find a file called
  585.         LOGIT.LOG.  If subdirectories are being used, LogIt! will
  586.         place this file in the root directory unless otherwise
  587.         specified.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.                 Page 8
  597.  
  598.  
  599.  
  600.         Specify the drive, directory and name for the file which 
  601.         LogIt! is to use to record data by using the DOS SET 
  602.         command.  For example, if all data is to be recorded in a 
  603.         file called LOGIT.LOG in the root directory in drive C:  
  604.         include the following in your AUTOEXEC.BAT file prior to 
  605.         invoking LOGIT;
  606.  
  607.                    SET LOGIT.LOG=C:\LOGIT.LOG
  608.  
  609.  
  610.         Generally, for floppy disk users, it will be best to 
  611.         specify:
  612.  
  613.                    SET LOGIT.LOG=A:\LOGIT.LOG
  614.  
  615.         You can use the SET command to put the log file anywhere
  616.         you wish (e.g. into a \LOGIT subdirectory) and give it
  617.         whatever name you wish (e.g. JIMS.LOG).  Thus:
  618.  
  619.               SET LOGIT.LOG=C:\LOGIT\JIMS.LOG
  620.  
  621.  
  622.         2.   Use the PATH command to tell the computer where to
  623.              find LOGIT.COM regardless of which drive and directory 
  624.         is the default.
  625.  
  626.         The DOS command "PATH" specifies that the computer will
  627.         search for LOGIT.COM on one or more specific drives and
  628.         directories rather than on just the default drive.  For
  629.         example, to type LOGIT at any DOS prompt (regardless of
  630.         which drive is the default) have, as part of the
  631.         AUTOEXEC.BAT file, the command:
  632.  
  633.                       PATH=C:\; [etc.]
  634.  
  635.         Floppy disk users should use:
  636.  
  637.                   PATH=A:\; 
  638.  
  639.  
  640.         4.   How to set up the AUTOEXEC.BAT file:  
  641.  
  642.         For hard disk users:
  643.  
  644.                 [program to set system clock]
  645.                 PATH=C:\;
  646.                 SET LOGIT.LOG=C:\LOGIT.LOG
  647.                         LOGIT
  648.  
  649.         For floppy disk users:
  650.  
  651.                 [program to set system clock]
  652.                 PATH=A:\;
  653.                 SET LOGIT.LOG=A:\LOGIT.LOG
  654.                 LOGIT
  655.  
  656.  
  657.                 Page 9
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.         Note that if there is nothing (not even a space or a
  665.         switch) after the command LOGIT the system will display
  666.         a prompt for a Start entry.  If you wish to use a switch
  667.         (e.g. -^E so that program use is not recorded) and still
  668.         want to have the prompt, enter the command LOGIT twice as
  669.         in the example below. 
  670.  
  671.                 [program to set system clock]
  672.                 PATH=C:\;
  673.                 SET LOGIT.LOG=C:\LOGIT.LOG
  674.                 LOGIT -^E
  675.                 LOGIT
  676.  
  677.         When the AUTOEXEC.BAT file execution
  678.         reaches LOGIT, the LogIt!  prompt will be displayed:
  679.  
  680.             Enter your LOGIT information now:
  681.  
  682.         Alternatively,  whatever is to be recorded for 
  683.         the "S>" (START) entry can be included in the
  684.         AUTOEXEC batch file, e.g.:
  685.  
  686.                 [program to set system clock]
  687.                 PATH=C:\;
  688.                 SET LOGIT.LOG=C:\LOGIT.LOG
  689.                 LOGIT -^E
  690.                 LOGIT [this is a start information entry]
  691.  
  692.         This will avoid the need to enter data while the 
  693.         batch file is executing.
  694.  
  695.         After you run LogIt! for the first time, the DOS prompt
  696.         will return, and the initial message will not be shown
  697.         again.  This is true even when LogIt! is recording data
  698.         about program changes, when the <ALT><INS> hotkey is
  699.         pressed or when the command "LOGIT" is typed to make an
  700.         information entry.
  701.  
  702.         Once LogIt! is RAM resident, anything - even just a 
  703.         space - after the command LOGIT will keep the 
  704.         window from popping up.  Thus you will need to be
  705.         careful while writing batch files to avoid 
  706.         putting spaces after the LOGIT command which 
  707.         would keep LogIt! from forcing an entry.
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.                                Page 10
  718.  
  719.  
  720.  
  721.  
  722.  
  723.     D.   Other operating notes:
  724.  
  725.     Be sure that enough room has been left on the disk chosen
  726.     for the LOGIT.LOG log file that LogIt! will create and
  727.     maintain.  As noted above, LogIt! will add about 25 bytes
  728.     each time an INFORMATION or a PROGRAM/DOS entry is made.
  729.     When available log file space is used up, you can use the 
  730.     LOGITDMP to convert the data to a file on another disk for 
  731.     archive purposes or you can summarize it with LOGITRPT. 
  732.  
  733.     It is possible to copy and concatenate the original binary files
  734.     if needed for archive purposes.  See a DOS handbook for 
  735.     instructions on these operations if you are not familiar with 
  736.     them.  
  737.  
  738.     If LogIt! cannot create or write into a LOGIT.LOG file, due
  739.     to a full disk or a write protect, this will not impede
  740.     operation of programs.  An error message from LogIt! will
  741.     be displayed, but your program will run without problems.
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.                 Page 11
  778.  
  779.  
  780.  
  781.  
  782.      V.   HOW TO START LogIt! AND ENTER INFORMATION
  783.  
  784.  
  785.     A.   How to run LogIt!
  786.  
  787.     LogIt! can be invoked at any DOS prompt by the command:
  788.  
  789.                             LOGIT
  790.  
  791.     There are several command-line switches that can be used
  792.     to specify the way in which LogIt! will record information.
  793.     They can be used when you first run LogIt! or any time 
  794.     thereafter.   These are:  
  795.  
  796.               -E     (default) - records PROGRAM/DOS entries
  797.                  and exits ("everything")
  798.                       -^E   - records only START and INFORMATION
  799.                  entries ("Not-Everything")    This switch
  800.                  is useful when you wish to limit the size 
  801.                  of the LOGIT.LOG record - a feature 
  802.                  especially handy for people like programmers
  803.                  who are constantly in and out of many
  804.                  programs or where program data is not 
  805.                  desired.  However, note that when this switch
  806.                  is used you must make an information entry
  807.                  with the hotkey or the command LOGIT to record
  808.                  a proper exit.
  809.               -H     (default)  - enables <ALT><INS> hotkey
  810.                       -^H   - disables hotkey
  811.  
  812.  
  813.     B.   How to make LogIt! entries:
  814.  
  815.     Remember that LogIt! tracks two types of data for you.  First,
  816.     LogIt! tracks PROGRAM and DOS use (PROGRAM/DOS entries).  LogIt!
  817.     will not, however, track the use of internal DOS commands such 
  818.     as COPY, DEL, TYPE  and the like.
  819.  
  820.     Second, LogIt! tracks usage according to INFORMATION entries 
  821.     (including the START entry which is really a special case of the
  822.     INFORMATION entry).
  823.  
  824.     There is no need to enter program names since LogIt! records 
  825.     program use automatically unless this feature is disabled.  
  826.     If you don't want to record all program use, but still want
  827.     some information entered you can either use a batch file to 
  828.     run your program and include the command LOGIT with the 
  829.     appropriate information after LOGIT on the command line or just
  830.     have the command LOGIT in the batch file with nothing after it.
  831.     In this case the window will come up and prompt you for 
  832.     information.  Alternatively, you can use the <ALT><INS> hotkey.
  833.     All of these alternatives will, however give you only 
  834.     INFORMATION entries since the PROGRAM/DOS recording function has
  835.     been disabled. 
  836.  
  837.  
  838.                 Page 12
  839.  
  840.  
  841.  
  842.  
  843.     Information data can be entered in three ways.   
  844.  
  845.     First, an information entry can be made using the command LOGIT 
  846.     with the entry following it.  This can be done either manually 
  847.     or from a batch file.  e.g.:
  848.  
  849.             LOGIT [message]
  850.  
  851.     Second, the <ALT><INS> hotkey can be used to enter data at any
  852.     time, including from within other programs without having to 
  853.     exit them.  When <ALT><INS> is typed, a window will appear at 
  854.     the top of the screen, and the information can be entered.  As 
  855.     soon as the RETURN key is pressed, the window will disappear, the 
  856.     information will be written to disk, and the computer will resume 
  857.     its previous task.
  858.  
  859.     Note that if the hotkey is pressed after the beginning of a
  860.     DOS entry (before the RETURN key is pressed for that entry), 
  861.     it is necessary to press RETURN before the window will pop up.  
  862.     This is because LogIt! will not "see" the <ALT><INS> combination 
  863.     which is still in the keyboard buffer.  The window will pop up 
  864.     immediately after RETURN is pressed, and the DOS command will be 
  865.     processed as soon as LogIt! is done writing the entry to the disk.
  866.  
  867.     The third, and very useful way, is to include the command LOGIT 
  868.     with nothing after it in a batch file to "force" an entry since
  869.     it is easy to forget to make entries unless there is a reminder.   
  870.  
  871.  
  872.     C.   Tips for making INFORMATION entries:
  873.  
  874.     To make it easier to total the elapsed times recorded in
  875.     LogIt! records, be consistent in the use of the identification 
  876.     codes used in making information entries.  LOGITRPT will 
  877.     not distinguish between upper and lower case when making 
  878.         summaries so the entries "1a" and "1A" will be seen as being
  879.         the same.  
  880.  
  881.     It is suggested that a code be decided upon to help record
  882.     information in a consistent manner such as the following:
  883.  
  884.         First Character   Second Character
  885.  
  886.         1 = George        A = Personal Use
  887.         2 = Sally         B = Business (Smith Acct)
  888.         3 = Robin         C = Business (Jones Acct)
  889.         4 = (etc)
  890.  
  891.     Any number-letter combination will work.   Again, remember to
  892.     be consistent in the use of upper or lower case.
  893.  
  894.     Thus, enter:
  895.                                LOGIT 3B
  896.  
  897.  
  898.                 Page 13
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.     to show Robin working on Smith Account.   Of course, actual
  906.     project or account numbers could be used as well if desired.
  907.  
  908.     Record more detailed information by adding notes to the
  909.     entry following the code.  This will also be recorded as
  910.     part of the entry for that time in LOGIT.LOG.  A maximum of 
  911.     128 characters may be used for each LogIt! entry if the entry 
  912.     is made with the command LOGIT, and a maximum of 57 using 
  913.     the <ALT><INS> hotkey.  However -- LOGITRPT will truncate all
  914.     entries to 20 characters, so information more than 20 characters
  915.     will not appear in summary reports.
  916.  
  917.     If desired, you can use LogIt! to document the time individuals
  918.     spend at various tasks by having them type <ALT><INS> or the
  919.     command LOGIT with the appropriate string to identify the activity.
  920.     Thus, an person can log his or her time towards various projects and 
  921.     it is easy to generate LogIt! records even for non-computer
  922.     related tasks.
  923.  
  924.     It is best to establish a code for each user and job and include 
  925.     a text file with these codes as a reminder message in your 
  926.     AUTOEXEC.BAT or other batch files in the line just before the 
  927.     command "LOGIT", e.g.,
  928.  
  929.                    TYPE LOGIT.MSG
  930.                    LOGIT
  931.  
  932.     where LOGIT.MSG is a text file containing the list of
  933.     available codes identifying the various people and/or
  934.     accounts.
  935.  
  936.  
  937.  
  938.         When entering LogIt! information whether from the command line,
  939.         a batch file, or the window, you should not enter control codes
  940.         of any kind since these will be transferred to the printer 
  941.         and may then change the printer settings disrupt the printer's
  942.         activity.   Enter letters or numbers only.  The LOGITRPT program
  943.         will convert all letters to capital letters, so upper versus 
  944.         lower case is not important unless you plan to do further
  945.         processing on the text or DIF output of LOGITDMP.
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.                 Page 14
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.      VI.   HOW TO EXIT LogIt!
  967.  
  968.     Once LogIt! has been invoked, there is no way to exit or stop the 
  969.     logging process without rebooting the system or using one of the 
  970.     utilities that allow you to release RAM resident programs.  
  971.     This feature increases LogIt!'s value as an accounting tool.
  972.  
  973.     LogIt! records exit times automatically by assuming that
  974.     the time of a return to DOS, followed by a reboot,
  975.     indicates the end of machine usage.  If a long time is
  976.     spent working in DOS after leaving the program and that
  977.     time must be recorded, leave a time mark for the exit.
  978.     This is done by using the <ALT><INS> hotkey or typing "LOGIT".
  979.  
  980.     Obviously, if you just shut down the computer without making
  981.     an exit to DOS (or crash it) LogIt! has no way of figuring 
  982.     out when the use of the machine ended and thus cannot calculate
  983.     elapsed times and keystrokes for the last PROGRAM/DOS and 
  984.     INFORMATION entries.   Thus you will see blanks for these 
  985.         last entries -- and in any case for the last DOS entry of the 
  986.         computer run.
  987.  
  988.     If you wish to use the -^E option to conserve file space, then 
  989.     use the <ALT><INS> hotkey or incorporate the command LOGIT into 
  990.     a "quit" batch file to make a final entry that will enable the 
  991.     program to calculate times and keystrokes properly.
  992.  
  993.     If there will be an extended period of time away from the
  994.     computer, use the <ALT><INS> hotkey or the LOGIT command to
  995.     note the time leaving and the time returning.  The keystroke
  996.     counter gives another, time-independent, means of determining
  997.     computer usage.
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.                 Page 15
  1019.  
  1020.  
  1021.  
  1022.  
  1023.      VII.   HOW TO USE LOGITRPT TO SUMMARIZE LogIt! RECORDS
  1024.  
  1025.     LOGITRPT will take the data in the file LOGIT.LOG generated by 
  1026.     the LOGIT.COM  program of LogIt! and convert it into a summarized 
  1027.     record of computer use using LOGITDMP as a subroutine.
  1028.  
  1029.         The new LOGITRPT.EXE that comes with Version 3.02S has much 
  1030.         more sophisticated log processing and reporting routines.  You can:
  1031.  
  1032.                 *   select date ranges to process 
  1033.                 *   display the data just for selected users or programs 
  1034.                 *   get either a summary report with all entries by one 
  1035.                     user/program combination combined for summary purposes 
  1036.                     or get a detailed report with every record displayed.
  1037.                 *   set reporting defaults and change them at will
  1038.  
  1039.      A.  What does LOGITRPT do?
  1040.  
  1041.          LOGITRPT will produce a summarized report of your
  1042.          computer's use.  The report will include, summarized
  1043.          by INFORMATION and PROGRAM/DOS entries:
  1044.  
  1045.         *    total keystroke counts for each entry 
  1046.         *    keystrokes/hour for each entry
  1047.         *    keystrokes as percent of total for each entry
  1048.         *    total elapsed time for each entry
  1049.         *    elapsed time as percent of total for each entry
  1050.  
  1051.     LOGITRPT will group all activities of a specific type 
  1052.     together using INFORMATION entries and (if LogIt! was 
  1053.     enabled to record them) PROGRAM/DOS entries.  It will sort the 
  1054.     entries according to type of entry and summarize the data for 
  1055.     each discrete entry.  
  1056.  
  1057.         Upper and lower case entries are not all transformed to upper
  1058.         case so the use of case need not be consistent when making entries.
  1059.  
  1060.     LogIt! keeps track of two types of information;  the data related 
  1061.     to INFORMATION entries and the data related to the PROGRAM/DOS 
  1062.     entries.  If LOGIT was used with the -^E switch there will be 
  1063.     no PROGRAM/DOS entries summarize in a report.
  1064.  
  1065.     The files LOGITLOG.TXT and the created .DBF files are temporary 
  1066.     files and will be overwritten the next time you run  LOGITRPT.
  1067.     If you want to save these files they should be renamed or copied 
  1068.     to a different disk or directory.  LOGITRPT will NOT ask you 
  1069.     before overwriting these files.
  1070.  
  1071.     The created V3DB1.DBF AND V3DB2.DBF are standard dBase III+(R) 
  1072.         files which can be used by dBase III+(R) or a .DBF 
  1073.         file-compatible program if you have one.
  1074.  
  1075.     The file LOGITLOG.TXT is just the text output of LOGITDMP.EX 
  1076.     (See below for details as to how to use this file.)
  1077.  
  1078.  
  1079.                 Page 16
  1080.  
  1081.  
  1082.  
  1083.  
  1084.      B.  How To Use LOGITRPT
  1085.  
  1086.     First, change your default drive and directory to \LOGIT, and
  1087.     then enter the following:
  1088.  
  1089.                               LOGITRPT
  1090.  
  1091.     You will see an opening screen.  If the defaults are satisfactory,
  1092.         simply press <ENTER> and log processing will proceed.  
  1093.  
  1094.         Defaults displayed on the screen are:
  1095.  
  1096.            LogIt! log file to report from   => C;\LOGIT.LOG
  1097.              (Selects drive, director, filename for LogIt! log file.
  1098.               Default is C;\LOGIT.LOG.)
  1099.  
  1100.            Limit report date range [Y] or report entire log [N] => N
  1101.              (Used if you wish to report only a portion of the LogIt! 
  1102.               file between two dates.  Default is "N".)
  1103.  
  1104.            Report for selected user/program only                => N
  1105.              (Used if you wish to report only for certain users or
  1106.               activities.  Default is "N".)
  1107.  
  1108.            Quick dump of untotaled LogIt! record                => N
  1109.              (Simply runs LOGITDMP.EXE as a fast routine and provides
  1110.               no summarization or other processing of data except for
  1111.               calculating elapsed times.  Will not allow either date
  1112.               limits or reports for selected users/programs. 
  1113.               Default is "N".)
  1114.  
  1115.            Detailed report of EVERY LogIT! record               => N
  1116.              (Does all the processing including percentages of time
  1117.               and keystrokes for used by each individual LogIt! 
  1118.               entry, but does not summarize all entries for each 
  1119.               user.  Allows for date and user/program limits. 
  1120.               Default is "N".)
  1121.  
  1122.            Summary report of LogIt! data                        => Y
  1123.              (Does all the processing, accepts limits, and 
  1124.               summarizes the computer usage for each user/program
  1125.               combination.  Default is "Y".)
  1126.                                             
  1127.            Report to  SCREEN                                    => N
  1128.              (Sends the report to the screen.  Default is "N".)
  1129.  
  1130.            Report to  PRINTER                                   => Y
  1131.              (Sends the report to the printer.  Default is "Y".)
  1132.  
  1133.            Report to FILE                                       => N
  1134.              (Sends the report to a text file.  The default 
  1135.               filename is C:\LOGIT\LOGRPT.TXT.  Default is "N".)
  1136.  
  1137.  
  1138.  
  1139.                                Page 17
  1140.                                                            
  1141.  
  1142.  
  1143.         If you wish to change any of these defaults, simply type "N"
  1144.         and you will see the same screen but with the ability to alter
  1145.         the defaults either temporarily or permanently.
  1146.  
  1147.         The default LogIt! log file is C:\LOGIT.LOG.
  1148.     If your log file is some other file, you can enter that file
  1149.     specification including drive, directory and file name.
  1150.     (e.g.  D:\LOGIT\JIMS.LOG).  
  1151.  
  1152.         If LOGIT.COM was always invoked with the -^E switch, there 
  1153.         will be no PROGRAM/DOS entries to report.
  1154.  
  1155.  
  1156.     C.  Notes on screen display of LOGITRPT report:   When the screen 
  1157.         display option is used with the "Report for selected user/program 
  1158.         only" option you will see that the screen will often display only
  1159.         a few records (or even none) at any one time.   All selected 
  1160.         records will be displayed, but you may have to hit the <RETURN> 
  1161.         key several times to see them.
  1162.  
  1163.  
  1164.     D.  Cleanup procedures:
  1165.  
  1166.         Because LOGITRPT generates very large working files while
  1167.         processing log data, it may be useful to delete these files 
  1168.         when you are done to free up disk space.  If not deleted, 
  1169.         these files will be overwritten the next time you run 
  1170.         LOGITRPT.  The working files increase the disk space used
  1171.         by LogIt! by an amount roughly equal to 50 times the size
  1172.         of the LOGIT.LOG file.  
  1173.  
  1174.         If you wish to save LOGITLOG.TXT or .DBF files for archival
  1175.         or other purposes you should rename or copy these.
  1176.  
  1177.         The original log file (Usually LOGIT.LOG) will not be deleted
  1178.         during the cleanup procedure and you should delete or rename
  1179.         this manually if you want to start a new log file.
  1180.  
  1181.         To run the cleanup procedure, simply enter:
  1182.  
  1183.                             CLEANUP
  1184.  
  1185.         at any DOS prompt while you are in the /LOGIT directory.
  1186.  
  1187.  
  1188.     E.  Other notes regarding LOGITRPT:   
  1189.     
  1190.     LOGITRPT does a great amount of file accessing while it 
  1191.     creates databases, indexes them and then sorts and processes 
  1192.     the LogIt! data, and therefore you should expect processing to 
  1193.     take a while, especially if the LOGIT.LOG file is large.
  1194.  
  1195.     Disk caching programs will also speed this type of operation 
  1196.     greatly but there have been problems with compatibility with 
  1197.     some of them.  The one that comes with PC-TOOLS (r) Ver 4.2 
  1198.         seems to have worked fine.
  1199.  
  1200.                               Page 18
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.      F.  Other uses for LOGITLOG.TXT, V3DB1.DBF and V3DB2.DBf
  1208.  
  1209.          1.   Displaying detailed data:  
  1210.  
  1211.          The most detailed level of record keeping is the text file 
  1212.          (LOGITLOG.TXT) generated by LOGITDMP from the original LogIt! 
  1213.          binary data file.  You can see the detailed entry by entry 
  1214.          record by entering
  1215.  
  1216.             TYPE LOGITLOG.TXT
  1217.  
  1218.      after LOGITRPT has finished running and you are back at the
  1219.      DOS prompt.  You can print this detailed data if you wish by 
  1220.      simply using the command 
  1221.  
  1222.             COPY LOGITLOG.TXT PRN
  1223.  
  1224.      Alternatively, you can look at this file with a word processor
  1225.      (in the non-document mode) or a text editor.  The file can even
  1226.      be altered with a word processor (in the non-document mode) or
  1227.       a text editor.  If you do this, you will still have the 
  1228.      LogIt! binary file as a secure archive record if you need it. 
  1229.  
  1230.      2.   Using V3DB1.DBF and V3DB2.DBF  
  1231.  
  1232.          These can be used in exactly the same manner as any other 
  1233.          dBASE III+(R) file.  The one other created .DBF file, 
  1234.          V3DB3.DBF could be used but has less useful information. 
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.                 Page 19
  1257.  
  1258.  
  1259.  
  1260.  
  1261.      VIII.   HOW TO USE LOGITDMP TO READ LogIt! RECORDS
  1262.  
  1263.     A.  General Operations:
  1264.  
  1265.     You can use the LOGITDMP program for a quick display of the log
  1266.     on the screen, to print a detailed entry-by-entry unsummarized 
  1267.         record, or to create a new text or DIF file of logged data.
  1268.  
  1269.     The following data reporting options are available for LOGITDMP.
  1270.  
  1271.              -I   Displays information entries only
  1272.                  -S   Displays all times in "HR MN SEC" format
  1273.              -D   Produces a DIF file in addition to text to the screen
  1274.  
  1275.         The -I option:
  1276.         The files generated by LOGITDMP can list either the total
  1277.         activity of the computer, including all program changes, 
  1278.         or can, by use of the command "LOGITDMP -I", display the
  1279.         elapsed times only for those entries with the "I>" and "S>"
  1280.         (information and start) record type codes, ignoring 
  1281.         the "P>" and "D>" (program and DOS) entries.  This option 
  1282.         is useful where the great detail provided by the program 
  1283.         and DOS entries is not needed.
  1284.  
  1285.         If the -^E switch was given with the command 
  1286.         LOGIT, there will be only information entries to report 
  1287.         from the LOGIT.LOG file regardless of which option is 
  1288.         used with LOGITDMP.
  1289.  
  1290.         The -S Option
  1291.  
  1292.         Adding an "S" after the "-" mark will cause LOGITDMP to
  1293.         display all entry and exit times in "HR MN SC" format
  1294.         and elapsed times in the same format but with the field 
  1295.         headings (added only if a DIF file is created) EH, EM, ES 
  1296.         to designate elapsed hours, minutes and seconds. As a 
  1297.         default, clock times will be reported in hours and
  1298.         minutes, but not seconds, and elapsed times will be
  1299.         reported as decimal hours.
  1300.  
  1301.         The -D Option
  1302.  
  1303.         Adding a "D" after the "-" mark will cause LOGITDMP to
  1304.         create a DIF file for use in a spreadsheet or database
  1305.         program if that works better in a particular application.
  1306.         If a DIF file is generated, field headings will be 
  1307.         provided as follows:
  1308.  
  1309.                 YR, MO, DA, HR, MN, TY, KEYS, ETIME, INFO
  1310.  
  1311.         As noted above, if the -S option is also used, the 
  1312.         structure will be:
  1313.  
  1314.         YR, MO, DA, HR, MN, SC, TY, KEYS, EH, EM, ES, INFO    
  1315.  
  1316.  
  1317.                 Page 20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.                 Using Multiple Options
  1323.  
  1324.         To use more than one of the above options at one time, just
  1325.         put all options desired together after the "-".  Thus to
  1326.         show only information entries, the time to the nearest
  1327.         second in "HR MN SEC" format, and generate a DIF file,
  1328.         type:
  1329.  
  1330.                       LOGITDMP -ISD LOGIT.LOG
  1331.  
  1332.  
  1333.  
  1334.         Usually, as in the example above, the filename that is the
  1335.         operand for LOGITDMP will be C:\LOGIT.LOG unless another 
  1336.         name has been specified. The following examples
  1337.         assume that LOGIT.LOG is in the root directory of the
  1338.         C: drive (C:\) and LOGITDMP.EXE is in the \LOGIT 
  1339.         directory.  
  1340.  
  1341.  
  1342.     B.   How to use LOGITDMP:
  1343.  
  1344.     1.  To display a LogIt! log on the screen, enter:
  1345.  
  1346.                    LOGITDMP [drive:]log filename
  1347.  
  1348.         For example, use (while in \LOGIT as the default directory):
  1349.  
  1350.                          LOGITDMP C:\LOGIT.LOG
  1351.  
  1352.     2.  To print a LogIt! log on the printer, type:
  1353.  
  1354.                         LOGITDMP [drive:]log filename>PRN
  1355.  
  1356.         For example, use (while in \LOGIT as the default directory):
  1357.  
  1358.                            LOGITDMP C:\LOGIT.LOG>PRN
  1359.  
  1360.  
  1361.     3.  To convert the binary LOGIT.LOG file to an ASCII (text) file
  1362.             on a disk, type:
  1363.  
  1364.                        LOGITDMP [drive:]log filename>[newdrive:]newfile
  1365.  
  1366.        For example, use (while in \LOGIT as the default directory):
  1367.  
  1368.                          LOGITDMP C:\LOGIT.LOG>A:LOGIT.TXT
  1369.  
  1370.         when a file called LOGIT.TXT is to be created on the 
  1371.         disk in drive A.
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.                 Page 21
  1379.  
  1380.  
  1381.  
  1382.  
  1383.     4.  To convert the binary LOGIT.LOG file to a Data
  1384.         Interchange Format (DIF) file, use the "-D" option when
  1385.         invoking LOGITDMP. Note the new DIF file, LOGITLOG.DIF
  1386.         will be written to the default drive and directory.  Thus, type:
  1387.  
  1388.                        LOGITDMP -D [drive:]filename
  1389.  
  1390.         For example, use:
  1391.  
  1392.                    LOGITDMP -D C:\LOGIT.LOG
  1393.     
  1394.  
  1395.         when a DIF file is to be created on the default
  1396.         drive. It is not possible for the program to concatenate
  1397.         (add to) a DIF file once it has been created.
  1398.  
  1399.     When you run LOGITDMP with the -D option, the log will
  1400.         be displayed in text format on the screen (or the printer
  1401.         if you typed ">PRN" after the command) while LOGITDMP
  1402.         is creating a new file called LOGITLOG.DIF on the default
  1403.         drive.  LOGITLOG.DIF can then be renamed to any desired
  1404.         filename as long as the suffix ".DIF" is retained.
  1405.         To create both a text and a DIF file, enter:
  1406.  
  1407.                    LOGITDMP -D LOGIT.LOG>[drive][newfile]
  1408.  
  1409.     This will create both a DIF file on the default drive and
  1410.        a text file on the newly specified drive.
  1411.  
  1412.  
  1413.     C.   How to View and Print the Disk Files Created by LOGITDMP
  1414.  
  1415.     To view the text files created by LOGITDMP, use the TYPE command.  
  1416.     To print the text files the COPY command can be used with
  1417.     >PRN at the end which will redirect the output of the file to
  1418.     the printer.  e.g. 
  1419.  
  1420.             COPY LOGITLOG.TXT  PRN
  1421.  
  1422.  
  1423.     D.   How to Interpret Records Produced by LOGITDMP
  1424.  
  1425.     The LOGITDMP program will report the contents of the
  1426.     LOGIT.LOG file with four codes denoting starting and
  1427.     elapsed times for different types of information.  The
  1428.     report can go to either the screen (default), a text file
  1429.     on a disk, or the printer.  The LogIt! report will look
  1430.     like this if the default configuration of LOGITDMP (ASCII
  1431.     text file in readable format sent to the screen) is used.
  1432.     However, there will be no headers or line numbers, which
  1433.     are added here for clarity.   If the -S option switch has been
  1434.     used, there will be additional columns to display the
  1435.     data in HR-MN-SEC format.
  1436.  
  1437.  
  1438.                 Page 22
  1439.  
  1440.  
  1441.  
  1442.           SAMPLE LogIt! RECORD PRODUCED BY LOGITDMP
  1443.  
  1444.  
  1445.          YR    MO  DA  HR  MN  TY  KEYS  ETIME  INFO  
  1446.    
  1447.          1985  01  30  10  53  S>  6438  1.50654  3B  
  1448.          1985  01  30  10  53  D>     8  0.00444     
  1449.          1985  01  30  10  54  P>  6422  1.48412  C:\WP\WRITE  
  1450.          1985  01  30  12  23  D>     8  0.00667     
  1451.          1985  01  30  12  23  I>  3789  0.97306  2C smith widgits
  1452.          1985  01  30  12  24  P>  2480  0.38722  C:\WP\WRITE  
  1453.          1985  01  30  12  47  D>    10  0.02111     
  1454.          1985  01  30  12  48  P>  1291  0.55417  C:\ACC\CALC   
  1455.          1985  01  30  13  21  D>     8  0.00722     
  1456.          1985  01  30  13  21  I>  1256  0.26806  2B  
  1457.          1985  01  30  13  22  P>  1248  0.25083  C:\WP\WRITE  
  1458.          1985  01  30  13  37  D>           
  1459.          1985  02  01  08  45  S>                 1A                       
  1460.          1985  02  01  09  25  P>                 C:\ACC\CALC
  1461.          1985  02  01  09  59  S> (new entry here and record continues)
  1462.  
  1463.  
  1464.     The keystroke counts (KEYS) and elapsed times (ETIME) recorded by
  1465.     LogIt! are of two general types: PROGRAM/DOS and INFORMATION.
  1466.  
  1467.       The "PROGRAM/DOS" KEYS and ETIME are recorded during the time
  1468.       that a program was actually in operation on the computer; that
  1469.       is, from the time the program was invoked until a return to
  1470.           DOS or to another program.
  1471.  
  1472.       The "INFORMATION" KEYS and ETIME are recorded from the time one
  1473.       information entry was made (using <ALT><INS> or the command
  1474.       "LOGIT") until EITHER another "INFORMATION" entry was MADE or
  1475.       the program senses that the computer was shut down by the fact
  1476.       that an exit to DOS was followed by a "start".
  1477.  
  1478.       If a program entry or an information entry is followed
  1479.       by a start, then LogIt! has to assume that a proper
  1480.       exit to DOS was not executed and therefore will show
  1481.       a blank as the KEYS and ETIME entries since no reasonable
  1482.           calculation is possible.  An example of this is seen
  1483.       in lines 13 and 14 of the sample record above.
  1484.  
  1485.       LogIt! records are displayed with the type of record (TY)
  1486.       indicated by one of four symbols to aid in calculations;
  1487.       these are: S>, P>, D>, I>,.  They mean:
  1488.  
  1489.              S>  =  LOGIT INVOKED 
  1490.              I>  =  INFORMATION ENTRY  
  1491.              D>  =  IN DOS  
  1492.              P>  =  PROGRAM (program in operation)
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.                 Page 23
  1500.  
  1501.     S> Start:
  1502.  
  1503.     This entry indicates a "START", which is the first invocation of 
  1504.     the LogIt! program after booting DOS.  It will contain (if supplied 
  1505.     by the user) an INFO entry. KEYS and ETIME will be calculated to 
  1506.     the next information (I>) entry or until the next return from a 
  1507.     program to DOS followed by a "start" (S>).  In a sense, the "S>" 
  1508.     elapsed time entry is a special case of the "I>" "INFORMATION"
  1509.     entry.
  1510.  
  1511.     I> Information entry:
  1512.  
  1513.     This entry contains the KEYS and ETIME of operation after entering
  1514.        LogIt! information by typing <ALT><INS> or the command "LOGIT"
  1515.        at any DOS prompt.  LOGITDMP will calculate the keystrokes (KEYS) 
  1516.     and time (ETIME) spent after each information entry by looking 
  1517.     ahead in LOGIT.LOG to either the next informational entry or 
  1518.     the time when a "D>" entry was followed by an "S>" entry, 
  1519.     indicating that the system was reset.
  1520.  
  1521.     P> Program:
  1522.  
  1523.        This entry contains the KEYS and ETIME for the time that the
  1524.        program listed was in operation.  Note that this calculation is not
  1525.       possible unless the program exited to DOS.  If this was not done,
  1526.        LOGITDMP will just display a blank for KEYS and ETIME.  LOGITDMP
  1527.        will calculate the elapsed time for programs from the invocation of
  1528.        a program to an exit to DOS regardless of whether or not any
  1529.        intervening information entries were made.   Note that while the
  1530.     program name appears in the "INFO" field it is of the PROGRAM/DOS
  1531.     type of entry.
  1532.  
  1533.     D> DOS:
  1534.  
  1535.        This entry contains the KEYS and ETIME for the time that the
  1536.        computer was in DOS.  Note that if there is an exit to DOS and the
  1537.        computer is shut down (as should be done), LOGITDMP cannot
  1538.        determine the KEYS or ETIME in DOS, and a blank will appear as the
  1539.        entry for KEYS and ETIME in the "D>" row as in row 12 of the
  1540.        example above.
  1541.  
  1542.     There is special significance to the combination of a "D>"
  1543.     followed by an "S>", as this indicates an exit from a
  1544.     program and a reboot. In these instances, the program will
  1545.     assume that the time indicated by the "D>" is the time that
  1546.     all activities were completed and will use this in
  1547.     calculating KEYS and ETIME for the "information" and
  1548.     "program" entries.  If there is not a "D>" followed by an
  1549.     "S>" combination (as if, for example, the computer was shut
  1550.     down without exiting to DOS), then calculations of KEYS and ETIME
  1551.     are not possible.  LOGITDMP will indicate this by
  1552.     displaying a blank for KEYS and ETIME, as in lines 13 and 14 of
  1553.     the sample, above.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.                 Page 24
  1561.  
  1562.  
  1563.  
  1564.  
  1565.      IX.  PROBLEMS AND ERRORS
  1566.  
  1567.     A.  When LogIt! will not create a record
  1568.  
  1569.     LogIt! cannot maintain a LogIt! log file if the disk in the
  1570.     default drive (or other drive specified by the SET command)
  1571.     is write protected or otherwise unavailable for the addition 
  1572.     of data to the log file.
  1573.  
  1574.     LogIt! will not record activities if DOS is not in
  1575.     operation (e.g. if BASIC is being used).  However, it will
  1576.     record the times BASIC was entered and DOS was re-entered.
  1577.  
  1578.     Some programs on protected disks require that either the
  1579.     system be booted from that disk to operate or DOS is not
  1580.     used. Thus, LogIt! will not work with these programs.
  1581.  
  1582.  
  1583.     B.  Common Error Messages
  1584.  
  1585.     Because of the large amount of memory required by LOGITRPT
  1586.     and its companion programs, errors will relate to this. 
  1587.     the first sign of a lack of sufficient free memory will be a 
  1588.     message stating:
  1589.  
  1590.         "Cannot Run LOGITDMP.EXE"
  1591.  
  1592.     Other common errors are
  1593.  
  1594.     ERROR 010  Cannot find a file.  This may refer to one of the
  1595.            database format files, but can also occur if due to
  1596.            a lack of memory or disk space LOGITRPT could not
  1597.            write one of the data files.
  1598.  
  1599.     ERROR 042  Printer not ready.  
  1600.  
  1601.  
  1602.     BAD LOGIT RECORD FOUND  There was a corrupted record in the
  1603.                     LOGIT.LOG binary file and the dump
  1604.                                 cannot continue.   It is necessary
  1605.                                 to delete the old LOGIT.LOG record
  1606.                     and allow the program to make a new
  1607.                 one.  All data in the old one will
  1608.                 be lost beyond the point of the
  1609.                     error.
  1610.     
  1611.     Unable to write to LOGIT log file....Please correct.  The
  1612.                 program was unable to write to the
  1613.                 file either because the disk was full
  1614.                 or otherwise inaccessible to LogIt!
  1615.  
  1616.         Printer problems/funny printing  Probably related to somebody
  1617.                                 entering a control character to the
  1618.                                 LogIt! window. See page 14.
  1619.  
  1620.  
  1621.                 Page 25
  1622.  
  1623.  
  1624.  
  1625.  
  1626.     C.   Who to contact if there are problems:
  1627.  
  1628.     Please write to us at the address below giving the details
  1629.     of the problem, address and phone number, and we will reply
  1630.     by mail or phone.  We would appreciate knowing of any
  1631.     problems, as this will help us improve the program.
  1632.  
  1633.             Robertson Software
  1634.             Dept. LS-3
  1635.             P.O. Box 576
  1636.             Geneva, IL, 60134
  1637.  
  1638.     Needless to say, we will be more enthusiastic about providing
  1639.     support to people who have paid the registration fee.  If you
  1640.     want a reply to your inquiry, PLEASE INCLUDE A SELF-ADDRESSED
  1641.     STAMPED ENVELOPE FOR OUR REPLY.  
  1642.  
  1643.     If you are writing about problems, please include information 
  1644.     about your system, including the brand, the amount of memory, any 
  1645.     special features, a printout of your CONFIG.SYS and AUTOEXEC.BAT 
  1646.     files, and a listing of any other RAM resident programs you are 
  1647.     using in addition to information about the programs you are using.  
  1648.     A printscreen dump of any error messages that will illustrate the 
  1649.     problem will also be helpful.
  1650.  
  1651.  
  1652.     D.   Detailed list of known conflicts and limitations 
  1653.  
  1654.     MS-Windows (R) - Don't even bother trying it.  The system will hang 
  1655.         when you exit a program running under Windows.
  1656.     VP-INFO (R)- Completely incompatible.  Problem was verified.  
  1657.     DESQview (R)- Unverified report of hanging the system when used 
  1658.               with LogIt!
  1659.     Software Carousel (R) -  ditto....
  1660.          Relay Gold (R) -  ditto
  1661.     PC-TOOLS (R) - Unverified report of problems when PC-Tools used in 
  1662.         RAM-resident mode.  Attempts to replicate have failed to 
  1663.                 show a problem.   No problems or reports of problems
  1664.                 otherwise.
  1665.     Norton Utilities (R)- For some strange reason, there is a problem
  1666.         with the File Editor of the Norton Utilities.  If LogIt!
  1667.         is running and you enter a ^C  character into the 
  1668.         file, the program abruptly exits to DOS.  This does NOT 
  1669.         occur with the PC-TOOLS file editor.
  1670.        Multimate (R) - A recent version of this program looks through 
  1671.         multiple directories for things and in doing so generates 
  1672.         many tiny logit files if you are logging program use.  
  1673.         There are also reported problems with keyboard in 
  1674.         Version 4. Earlier versions seem to work OK.
  1675.         CED - Loading order is important - Load LogIt! first. 
  1676.         Compiled Basic Programs - Rarely,  a problem will occur where the
  1677.                 bell will stay on for long times if the Hotkey is used.  
  1678.         No other problems.  It probably depends on which compiler 
  1679.         was used.
  1680.  
  1681.  
  1682.                 Page 26
  1683.  
  1684.  
  1685.     Disk Caching programs - LOGIT.COM appears to work well with all
  1686.         disk caching programs tested so far.  However, some 
  1687.         disk caching programs have trouble with compiled dBASE
  1688.         programs such as LOGITRPT.EXE.  While PC-CACHE (which 
  1689.         comes with PC-TOOLS)(R) works well with LOGITRPT.EXE.
  1690.     Programs invoking other programs (or COMMAND) - Not really a 
  1691.         problem,  but when one program invokes another, the number 
  1692.         of keystrokes and time spent in the parent program are 
  1693.         divided among the programs that were run under it.  If you 
  1694.         want to attribute all time and keystrokes to the parent 
  1695.         program you can do this by using a batch file with the 
  1696.         LOGIT command contained in it to invoke the parent program.
  1697.         That information entry will then contain the proper time 
  1698.         and number of keystrokes.  (It is best to also use the
  1699.                 command "LOGIT" in same batch file so that the information 
  1700.                 exit is properly recorded upon leaving the parent program.)
  1701.     Loss of LogIt! SET commands:    There have been rare instances of 
  1702.         Logit putting the LOG file in strange places - e.g. when 
  1703.         a program is invoked from a floppy disk, LogIt!  may put the
  1704.             file on that disk.  This may relate to the a secondary 
  1705.         program invoked by a primary program running out of 
  1706.         environment space when it tries to make a copy of the
  1707.         environment commands.  You may want to try increasing the
  1708.                 environment space.  You can use the following line in 
  1709.                 your CONFIG.SYS file:
  1710.                            SHELL=C:\COMMAND.COM /P /E:1200
  1711.                 or refer to your DOS manual.
  1712.     Graphics Screen Modes:  These versions of LogIt! will not
  1713.         bring up the window in a readable form when the screen is
  1714.         in graphics mode.  
  1715.  
  1716.  
  1717.      X.    REGISTRATION INFORMATION AND INVOICE FOR LogIt! (R)
  1718.  
  1719.     Please help us make the shareware concept work by paying us for 
  1720.     this program if you find it to be useful.  We also hope that you 
  1721.     will make it available to others who might like it.  
  1722.  
  1723.     Your payment of $20.00 gives you the right to use one copy of 
  1724.     LogIt! on one machine.  We request payment for each additional 
  1725.     copy in use.   Please remember that site licenses are available 
  1726.     for 10 or more copies; contact the authors at the address below 
  1727.         for more information.
  1728.  
  1729.         If you have previously paid for LogIt!, either shareware or via
  1730.         our SDDC contract, we would appreciate a nominal upgrade 
  1731.         registration fee of $10.00 for this version.
  1732.          
  1733.         If you wish, you can use the fold-up mailer below for sending 
  1734.     your check along with a small amount of information.  Please tape 
  1735.     so that the check does not fall out!
  1736.  
  1737.     Please separate mailer from this document.  
  1738.  
  1739.     To fold, tape check to *back* of side 2, then place mailer 
  1740.     printed side down.  Fold side 1 back, and then cover it with 
  1741.     side 3 also folded back.   Staple or tape closed.
  1742.  
  1743.                 Page 27
  1744. ..............................................................................
  1745. Side 1.
  1746. Enclosed is payment for ___ copies of LogIt! V3.02S @ $20/copy.  $____.__
  1747. Please make check payable to Robertson Software, and tape inside this
  1748. mailer.  (Mark here // and insert check for $10/copy for upgrades.)
  1749.  
  1750. Payment by: Name______________________________________
  1751.  
  1752.             Company __________________________________
  1753.  
  1754.         Street  __________________________________
  1755.  
  1756.         City/State/Zip/Country ___________________________________
  1757.  
  1758.         Phone (note if home or work) ______-______________ // H  // W
  1759. Planned use for LogIt! ________________________________________________
  1760. Where did you get your copy? __________________________________________
  1761. Any Comments?  (It's OK to use next side if you wish)
  1762. THANK YOU,   Alan Robertson and John Beasley
  1763.             fold back here and tuck this flap under first
  1764.  ------------------------------------------------------------------------------
  1765. Side 2.  (ok to use for comments - this is back of mailer)
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.               fold next side over to make front of mailer
  1787.  -----------------------------------------------------------------------------
  1788. Side 3                                               1st Class
  1789. FROM ________________________                             stamp
  1790.      ________________________                          here
  1791.      ________________________
  1792.      ________________________
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.             TO   Robertson Software
  1799.                  Dept. LS-3
  1800.                              P. O. Box 576
  1801.                      Geneva, IL,  60134
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808. LogIt!  Ver 3.02S 
  1809.